\ifx \allfiles \undefined
\documentclass{book}
\usepackage{rails-handbook-cn}
\begin{document}
\fi
%==============================
\chapter{前言}
\Large

\section{动机？}

Ruby on Rails 作为一个优秀的Web框架受到了巨大的关注，以其和谐统一的纯Ruby架构赢得了极大的声誉。社区活跃，发展迅速。

但是由于Rails是一个新型的产物，相关讨论与文档都很不健全，查找资料十分痛苦。中文界中合适的入门、提高、讨论的环境格外匮乏。这就让我萌生出要总结一下有关Rails的语法点的这样一个项目。作为一个框架，语法细小而繁多，语法记忆量要大于一门语言的学习（而且一不小心就容易搞错，况且加上频繁的版本更新），自然查找官方Guide和Api是一种方式，但是Guide是引导你走进Rails的大门，Api告诉你它是怎么具体实现的，而这个项目是当你入门之后，开始做自己的项目了，却总要时不时搜索查找语法项的时候提供一些给力的帮助。

更基础的入门学习请大家参考 电子工业出版社 引进的 《Web开发敏捷之道》 ，第三版已经完整的汉化了。这本书为Rails零基础的人打开了一道方便的大门，你可以通过它对Rails有一个基本的了解，并可以动手写一些Web应用了。

\section{特点？}

此项目旨在为简单入门之后的人们提供一个方便的中文手册，以及在Rails版本更新之间的语法变化给予提醒。

这个手册将会按照在开发过程中的一轮迭代为顺序进行编写，按功能模块来区分章节，并尽可能覆盖到各种不同的语法实现，以帮助大家更好的选择。

一开始这个手册可能会很粗线条，但是我会不停补完它的，并保持更新与官方版本同步。基础版本Rails 3.10beta。

这个手册是一本手册，所以阅读的时候直接跳转找需要的章节是没有什么问题的，我会降低各个章节之间的耦合度的，一个手册不应该依赖于上下文环境。

\section{Rails构成}

我们按照用户的一次请求处理的流程来浏览一下Rails的构成，以及推荐的命名规则：
\begin{description}
\item[路由 Route] 路由表用于将用户请求的url进行翻译，分发给制定控制器的制定动作，并将后续的参数传入。
\item[控制器 Controller] 控制器的名字应该是一个名词的单数，它是被操作的对象。
\item[动作 Action] 动作应该是一个动词，可以利用时态变化来区分动作的性质，它的宾语是所属的控制器，按照面向对象的思想来说可以理解成：Controller.Action(Params)
\item[模型 Model] 模型是一个名词的复数，它负责组织对象拥有的数据以及数据的校验工作，如果它与控制器的对象一致的话，应该在名称上保持一致。
\item[视图 View] 视图位于与控制器同名的文件夹内，每一个动作对应一个视图文件，共用的局部视图则以短下划线开头来命名。
\end{description}

\section{联系我们/提供帮助}

手册基于\LaTeX 编写，版本控制于Google Code上\texttt{\url{http://code.google.com/p/rails-handbook-cn/}}，生成的pdf我会定期更新到Downloads中去。

如果大家有什么好的建议与意见，请邮件联系我，帮助这个项目更好的为大家服务。谢谢。
我的邮箱\texttt{\url{mailto:Ranmocy@gmail.com}}

%==============================
\ifx \allfiles \undefined
\end{document}
\fi